home *** CD-ROM | disk | FTP | other *** search
/ Canadian Geographic Explorer / Canadian Geographic Explorer.iso / pc / comp.z / TABLET.HLP < prev    next >
Encoding:
Text File  |  1996-05-01  |  37.1 KB  |  944 lines

  1. @title{TABLET}{Tablet/Digitizing Table Notes}
  2. @keyword{Tablet Digitizing Digitising}
  3. @index{Tablet Setup}
  4. @index{Digitizing Tablet Setup Serial} 
  5.  
  6.  Digitizing tables (tablets) are used to physically point to a position (on 
  7.  a flat map, for instance).  In PCI software, such applications include:  
  8.  
  9.  - vector digitization of maps, 
  10.  - ground control point collection for image-to-map registration
  11.  
  12.  A tablet consists of a flat surface and a pointing device. Depending on
  13.  the manufacturer and model, the surface can range from 12 inches by 12
  14.  inches to 60 inches by 48 inches. 
  15.  
  16.  For PCI applications, a 16 button cursor is usually required. 
  17.  
  18.  The basic function of a tablet is to transmit the coordinate (position) of 
  19.  the cursor back to the host computer.  PCI software generally supports 
  20.  three modes:
  21.  
  22.  - Point mode: a coordinate is transmitted each time the user pushes a 
  23.    button and releases it.  
  24.  
  25.  - Switch-Stream (track, intermittent) mode: coordinates are transmitted 
  26.    continuously as a user holds down a button.
  27.  
  28.  - Stream (run) mode: coordinates are transmitted continuously, regardless 
  29.    of whether a button is held down or not.  
  30.  
  31.  Most tablets have a physical resolution of 1000 lines per inch (40 lines per
  32.  millimeter). 
  33.  
  34.  Note:  When PACE applications are run, they will automatically attempt to 
  35.  set the tablet to a "known" state by using software commands.  This "known" 
  36.  state may differ from the initial powerup state.  If other, non-PCI
  37.  applications are run which require the tablet, it may be necessary to 
  38.  power the tablet off and on again to restore the initial powerup state. 
  39.  
  40.  See Also: TBTEST, GCPWorks, GCIM, VECDIG
  41.  
  42. 1    Connecting Tablets
  43.  
  44.  Tablets are usually designed to act in a manner similar to terminals. That 
  45.  is, they are attached to RS-232C ports (terminal ports).
  46.  
  47.  Like other RS-232C devices, it is critical that the tablet and the port to 
  48.  which it is connected be configured to allow communication. 
  49.  
  50.  Most tablets come with jumpers or toggle switches that give a range of 
  51.  possible baud rates, parity, data bit size and stop bits. Check the 
  52.  documentation for the tablet to find which characteristics can be changed 
  53.  and how to interpret the current settings. In most cases the factory default 
  54.  settings should be used with PCI software. 
  55.  
  56.  For most systems, two things have to be done to enable using a digitizing
  57.  table:
  58.  
  59.   - Logins must be disabled on the port to which the tablet is connected.
  60.  
  61.   - Second, the port must be set to match the baud, parity, data bits and 
  62.     stop bits of the tablet.
  63.  
  64.  Both of these are very dependent on the operating system involved, and on 
  65.  the tablet to be used.
  66.  
  67. 2    Summasketch
  68. @keyword{Summasketch}
  69. @index{Summasketch}
  70.  
  71.  The factory default setting is for the Summagraphics Summasketch to 
  72.  transmit coordinates in packed binary mode.  However, PCI software
  73.  requires the Summasketch to transmit coordinates in ASCII mode.
  74.  Instructions for changing the appropriate jumpers are contained in the
  75.  PCI Installation Guide for your computer.
  76.  
  77.  Note:  For Windows 3.1 only, when using the PACE programs GCIM and VECDIG,
  78.  the tablet must be in packed binary mode.  However, when using GCPWorks
  79.  for Windows 3.1, the tablet must be in ASCII mode.
  80.  
  81.  Proper communications settings for the SummaSketch with PCI software are
  82.  as follows:
  83.  
  84.   9600 Baud
  85.   Odd Parity
  86.   8 data bits
  87.   1 stop bit 
  88.  
  89. 2    Micro-Grid II
  90. @keyword{Micro-Grid II}
  91. @index{Micro-Grid II}
  92.  
  93.  The  Summagraphics Micro-Grid II tablet comes in a  variety of sizes with 
  94.  a 4 or 16 button puck (cursor).  The Microgrid is expected to be 
  95.  transmitting in ASCII mode (default).  See the instructions that accompany 
  96.  your Microgrid to ensure that it is set up to transmit properly.  Proper 
  97.  communications settings for the Microgrid with PCI software are as follows:
  98.  
  99.   9600 Baud
  100.   Odd Parity
  101.   8 data bits
  102.   1 stop bit 
  103.  
  104. 2    IBM 5084
  105. @keyword{IBM 5084}
  106. @index{IBM 5084}
  107.  
  108.  NOTE:  This tablet is only supported on the IBM Risc System 6000 workstation
  109.  under the AIX operating system.
  110.  
  111.  PCI software expects that data from the IBM 5084 is sent in Binary Data
  112.  Format.  This format is the factory default.
  113.  
  114. 2    GTCO DigiPad
  115. @keyword{GTCO DigiPad}
  116. @index{GTCO DigiPad}
  117.  
  118.  NOTE:  This tablet appears to belong to a family of tablets.  PCI has
  119.  only tested the DigiPad 12.  From the documentation with the tablet, many 
  120.  members of the family appear similar.
  121.  
  122.  These tablets are very flexible, and require the user to set them up prior 
  123.  to use with the computer.  On the model 12, PCI software will work with 
  124.  the number 12 and number 64 settings.  To set the tablet into the correct 
  125.  mode on the model 12, choose the `S' on the superset menu, then `1' `2' or 
  126.  `6' `4'.  These are associated with `ARC/INFO' from ERSI and ROCTEK 
  127.  products respectively.
  128.  
  129.  Proper communications settings for the GTCO Digipad with PCI software are
  130.  as follows:
  131.  
  132.   9600 Baud
  133.   No Parity
  134.   8 data bits
  135.   1 stop bit 
  136.   ASCII mode
  137.  
  138. 2    Gentian/Altek
  139. @keyword{Gentian Altek}
  140. @index{Gentian}{Altek}
  141.  
  142.  On the Gentian (or Altek) logic board are switches which allow some 
  143.  flexibility in selecting the communication characteristics.  Refer to 
  144.  the manufacturer's documentation supplied with your Gentian.  PCI assumes 
  145.  that the Gentian or Altek tablet has the standard firmware installed and 
  146.  factory default settings in place.
  147.  
  148.  Proper communications settings for the Gentian with PCI software are as
  149.  follows:
  150.  
  151.   9600 Baud
  152.   Odd Parity
  153.   7 Data Bits
  154.   2 Stop Bits
  155.   Report Format 1 (controlled on Logic Board)
  156.  
  157. 2    CalComp 9100
  158. @keyword{Calcomp 9100}
  159. @index{Calcomp 9100}
  160.  
  161.  Using the Digitizer menu located on the CalComp, it is possible to set the 
  162.  baud rate, parity, stop bits and data bits.  The installation/reference 
  163.  manual supplied with your tablet gives more information on interpreting the 
  164.  current settings and making modifications.  
  165.  
  166.  Please note: using a CalComp 9100 with a 4 or 12 button puck has not been
  167.  fully tested, and is not guaranteed to work.
  168.  
  169.  If the tablet seems unresponsive, switch the power off and on again.  This 
  170.  forces a hardware reset.
  171.  
  172.  Proper communications settings for the CalComp with PCI software are as
  173.  follows:
  174.  
  175.   9600 Baud
  176.   Odd Parity
  177.   7 Data Bits 
  178.   1 Stop Bit
  179.  
  180. 2    CalComp 9500
  181. @keyword{Calcomp 9500}
  182. @index{Calcomp 9500}
  183.  
  184.  Using the Digitizer menu located on the CalComp, it is possible to set the 
  185.  baud rate, parity, stop bits and data bits.  The installation/reference 
  186.  manual supplied with your tablet gives more information on interpreting the 
  187.  current settings and making modifications.  
  188.  
  189.  Proper communications settings for the CalComp with PCI software are as
  190.  follows:
  191.  
  192.   9600 Baud
  193.   Odd Parity
  194.   7 Data Bits 
  195.   1 Stop Bit. 
  196.  
  197. 1    Communication Parameters
  198.  
  199.  Setting up communication between a computer and a tablet tends to
  200.  vary extensively depending on the operating system in use.  In many
  201.  cases, PCI attempts to handle the details of this; however, not all
  202.  operating systems allow setting all the necessary parameters in a
  203.  controlled manner.
  204.  
  205.  PCI software generally has the ability to set the baud, parity, data bits, 
  206.  and stop bits for a port to which a tablet is connected, while the tablet 
  207.  is being used.  Once the application completes, all settings revert to 
  208.  their original state.  Some operating systems, however, require alternate
  209.  methods of setting these parameters.  In all cases, users should examine
  210.  the sections discussing System Specific setup to ensure all the correct
  211.  steps are taken.
  212.  
  213.  PCI software will generally attempt to read the desired tablet settings
  214.  out of the Parameter file (PRM.PRM), if one exists; or, in the case of
  215.  windowing based software (such as GCPWorks), a control panel is displayed
  216.  to the user to allow this configuration.  The rest of this section will
  217.  discuss the setting of entries in the parameter file.  However, in the case
  218.  of the windowing software control panel, the type of information set is
  219.  the same; it is just achieved by selecting the appropriate values from
  220.  various menus.
  221.  
  222.  The TB00, TB0: and TB0: parameters in the parameter file hold information 
  223.  on the port name and configuration options.  When a PCI application is run, 
  224.  these parameters are used to access the correct port and (optionally) modify 
  225.  the baud, parity, data bits, and stop bits settings.
  226.  
  227.  Configuring these parameters is easiest done through the EASI procedure
  228.  CONFIGUR, which provides a menu driven interface for setting device 
  229.  parameters.  To run CONFIGUR, enter the following command at the EASI
  230.  prompt (or select CONFIGUR from Xpace):
  231.  
  232.   EASI> r configur
  233.  
  234.  When the menu appears, select `D' for Digitizing Table, and change the 
  235.  device name and configuration appropriately.
  236.  
  237.  To make the changes manually, enter the following commands at the EASI prompt:
  238.  
  239.    EASI> TB00 = "TB0:"
  240.    EASI> TB0: = "actual_device_name"
  241.    EASI> TB0# = type, baud, parity, data bits, stop bits
  242.  
  243.  where `actual_device_name' is the device name of the port to use on your
  244.  system (e.g. /dev/tty01).
  245.  
  246.  The TB0# parameter values have the following definitions:
  247.  
  248.   type:           1:  ASCII Summagraphics Summasketch
  249.                   3:  Gentian (Altek)
  250.                   4:  CalComp 9100 (4 button)
  251.                   5:  CalComp 9100 (12/16 button)
  252.                   6:  Summagraphics Microgrid II
  253.                   7:  CalComp 9500 (16 button)
  254.   baud:           0:  Retain current baud rate
  255.                9600:  Change to 9600 baud
  256.   parity:         0:  Retain current parity
  257.                   1:  Odd parity
  258.                   2:  Even parity
  259.                   3:  No parity
  260.   data bits:      0:  Retain current number of data bits
  261.                   7:  7 data bits
  262.                   8:  8 data bits
  263.   stop bits:      0:  Retain current number of stop bits
  264.                   1:  1 stop bit
  265.                   2:  2 stop bits
  266.  
  267.   For example:  TB0#=3,9600,1,7,2 would be for a Gentian tablet configured
  268.                     for 9600 baud, odd parity, 7 data bits and 2 stop bits.  
  269.                 TB0#=7,0,0,0,0 would be for a CalComp 9500 series tablet where 
  270.                     the port options already match the tablet, so no 
  271.                     modifications have to be made. 
  272.  
  273. 2    OSF/1 (Digital AXP)
  274.  
  275.  Digital AXP workstations usually come with two serial ports, (typically
  276.  the device names are /dev/tty00 and /dev/tty01).  Users should note 
  277.  that the first of these (/dev/tty00) is configured as a console 
  278.  terminal/printer port and cannot be used as a normal serial port.  This
  279.  usually limits digitizing tablets to being connected to the second port.
  280.  
  281. 3    Disabling Logins
  282.  
  283.  To ensure that a login process (getty) is not running against the port for
  284.  the digitizing table, search the file /etc/inittab for the line containing
  285.  the terminal device name.   The line should look something like this:
  286.  
  287.   tty01:23:respawn:/usr/sbin/getty /dev/tty01 9600 vt100
  288.  
  289.  where /dev/tty01 is the port to which the table is connected.  Edit the 
  290.  file, if necessary, commenting out the line (by placing a `#') at the
  291.  beginning of it):
  292.  
  293.   #tty01:23:respawn:/usr/sbin/getty /dev/tty01 9600 vt100
  294.  
  295.  Next, you must force the initialization process to close and to open the 
  296.  terminals according to the contents of the /etc/inittab file, by entering 
  297.  the following command (note this must be done as root or superuser): 
  298.  
  299.   # /sbin/init  q
  300.  
  301.  Note:  This will NOT affect terminals which are already logged in, and
  302.  therefore can be executed on a running system with active users. 
  303.  The next time the system is booted the /etc/inittab file will be
  304.  automatically referenced so the init command does not have to be reissued. 
  305.  
  306. 3    Communication Parameters
  307.  
  308.  Setting communication parameters under OSF/1 should be done through PCI
  309.  software as described in the general section, above.
  310.  
  311.  
  312. 2    OpenVMS (Digital AXP)
  313.  
  314.  Digital AXP workstations usually come with two serial ports, (typically,
  315.  under OpenVMS, the device names are TTA0: and TTA1:).  Users should note 
  316.  that the first of these (TTA0:) is configured as a console terminal/printer 
  317.  port and cannot be used as a normal serial port.  This usually limits 
  318.  digitizing tablets to being connected to the second port.
  319.  
  320.  Unlike on most systems, PCI's software does not change terminal port
  321.  settings under OpenVMS.  To do so, the "SET TERMINAL" command is used.
  322.  This allows setting of both the communications parameters, and disabling
  323.  logins on the port.
  324.  
  325.  Additionally, the protection code on the port must be set to allow general
  326.  users permission to access the port directly.  This is done using the
  327.  ``SET PROTECTION'' command.
  328.  
  329. 3    Port Settings
  330.  
  331.  The SHOW TERMINAL command can be used to check the current characteristics 
  332.  of the device associated with the port.  The SET TERMINAL command can be
  333.  used to change these characteristics to match them up with those of the 
  334.  tablet.  The following list shows some of the more important characteristics 
  335.  and the usual settings:
  336.  
  337.   $ SET TERMINAL characteristic term:
  338.  
  339.    Where `characteristic' is one of the following:
  340.  
  341.     Echoing:  Usually the host AXP echos any data       /NOECHO
  342.     transmitted  to  it  back   along  the  line.
  343.     Echoing must be disabled for tablets.
  344.  
  345.     Baud rates:  The  baud  rate  (usually  9600)       /SPEED=9600
  346.     on  the line and for the tablet should match.
  347.  
  348.     Parity:  Tablets transmit  with even, odd,  or      /PARITY=EVEN
  349.     no parity.  Most lines under  OpenVMS are set       /PARITY=ODD
  350.     to no parity initially.                             /NOPARITY
  351.  
  352.     Eight bits:  Each character of data is sent as      /NOEIGHT
  353.     either 7 bits or 8 bits.                            /EIGHT
  354.  
  355.     Type_ahead:  It is best to allow buffering of       /TYPE
  356.     coordinates in the typeahead buffer.  
  357.  
  358.     Broadcasting:  It is best to  prevent  broad-       /NOBROADCAST
  359.     casting  of messages  to the  tablet  in case
  360.     they are interpreted as commands.
  361.  
  362.     Permanent:  This must be used to ensure  that       /PERMANENT
  363.     changes  are  permanent.   This  may  require
  364.     system manager privileges.
  365.  
  366.  Other settings should be left at the default values.
  367.  
  368.  The SET TERMINAL command is normally inserted into the system startup 
  369.  command file, which is executed when the AXP system is rebooted.
  370.  (The system startup command file is called: SYS$MANAGER:SYSTARTUP_VMS.COM)
  371.  
  372. 3    Port Protection
  373.  
  374.  Setting the protection on the port is done by the command:
  375.  
  376.   $ SET PROTECTION=(S:RWLP,O:RWLP,G:RWLP,W:RWLP)/DEVICE term:
  377.  
  378.  As with the SET TERMINAL command, this too can be inserted into the
  379.  system startup command file (SYS$MANAGER:SYSTARTUP_V5.COM).
  380.  
  381. 3    Example
  382.  
  383.  The following shows an example output of the SHOW TERMINAL command for 
  384.  a port configured for a Summagraphics Summasketch tablet:
  385.  
  386.   Terminal TTA1:, device type unknown, is online, record-oriented device, 
  387.      carriage control.
  388.  
  389.      Error count                    0    Operations completed           28711
  390.      Owner process                 ""    Owner UIC                      [PCI]
  391.      Owner process ID        00000000    Dev Prot S:RWLP,O:RWLP,G:RWLP,W:RWLP
  392.      Reference count                0    Default buffer size              255
  393.  
  394.   Terminal: _TTA1:      Device_Type: Unknown       Owner: No Owner
  395.     Input:   9600     LFfill:  0     Width: 255     Parity: Odd
  396.     Output:  9600     CRfill:  0     Page:   66     Terminate on parity errors
  397.   Terminal Characteristics:
  398.     Passall           No Echo            Type_ahead        No Escape
  399.     No Hostsync       No TTsync          Lowercase         Tab
  400.     No Wrap           Hardcopy           No Remote         Eightbit
  401.     No Broadcast      No Readsync        No Form           Fulldup
  402.     No Modem          No Local_echo      No Autobaud       No Hangup
  403.     No Brdcstmbx      No DMA             No Altypeahd      Set_speed
  404.     No Line Editing   Insert editing     No Fallback       No Dialup
  405.     No Secure server  No Disconnect      No Pasthru        No Syspassword
  406.     No SIXEL Graphics No Soft Characters No Printer Port   Application keypad
  407.     No ANSI_CRT       No Regis           No Block_mode     No Advanced_video
  408.     No Edit_mode      No DEC_CRT         No DEC_CRT2       No DEC_CRT3
  409.     No DEC_CRT4
  410.  
  411. 2    DG/UX (Data General AViiON)
  412.  
  413.  Each Data General AViiON typically comes with at least three serial ports.  
  414.  The device names for the first three are /dev/tty00 for RS-232 A, 
  415.  /dev/tty02 for RS-232 B, and /dev/tty01 for RS-232 C.
  416.  
  417.  If you are using a port other than one of these, contact your system
  418.  manager to find out the device name.
  419.  
  420.  These serial ports come with 15-pin sockets, and are compatible with PC type
  421.  15-pin to 25-pin adaptors.
  422.  
  423. 3    Disabling Logins
  424.  
  425.  To ensure that a login process (getty) is not running against the port for
  426.  the digitizing table, the serial ports will be examined using `sysadm'.
  427.  
  428.  To use `sysadm', log in as root and enter the command: sysadm  
  429.  
  430.  To examine the serial ports, go into the `ttymgmt' submenu and select the 
  431.  `lstty' option.  
  432.  
  433.  If the serial port you wish to use is present (note /dev/tty01 is 
  434.  `TTY 1'), and the State is `on', then it will be necessary to turn it off.
  435.  
  436.  To turn off getty for that serial port, enter the `modtty' option on
  437.  the `ttymgmt' submenu, and change the logical state to a value of "off"
  438.  while not changing any other values.
  439.  
  440. 3    Port Protection
  441.  
  442.  Sometimes the serial port is write protected and normal users cannot
  443.  read/write to it properly (though the superuser, or root can).  The port
  444.  should be have full read/write access.  This can be done using the 
  445.  following command (issued by root or superuser):
  446.  
  447.   # chmod 666 /dev/ttynn                (where nn is port number)
  448.  
  449. 3    Communication Parameters
  450.  
  451.  Setting communication parameters under DG/UX should be done through PCI
  452.  software as described in the general section, above.
  453.  
  454. 2    HP/UX (Hewlett Packard 9000/7xx)
  455.  
  456.  Each HP 9000/7xx typically comes with at least two serial ports.  Normally, 
  457.  a terminal device already exists for each serial port, and there is
  458.  no need to create a new device.  Usually, the device name for `RS-232 1'
  459.  is /dev/tty00, and for `RS-232 2' is /dev/tty01.  However, if these 
  460.  terminal devices do not exist, they can be created using `sam', HP's 
  461.  system management utility.  To use sam, you must log in as root or become 
  462.  superuser, and enter the command: sam
  463.  
  464. 3    Disabling Logins
  465.  
  466.  To ensure that a login process (getty) is not running against the port for
  467.  the digitizing table, search the file /etc/inittab for the line containing
  468.  the terminal device name.   The line should look something like this:
  469.  
  470.   a0:2:respawn:/etc/getty -h tty01 9600
  471.  
  472.  where tty01 is the port to which the table is connected.  Edit the 
  473.  file, if necessary, commenting out the line (by placing a `#') at the
  474.  beginning of it):
  475.  
  476.   #a0:2:respawn:/etc/getty -h tty01 9600
  477.  
  478.  Next, you must force the initialization process to close and to open the 
  479.  terminals according to the contents of the /etc/inittab file, by entering 
  480.  the following command (note this must be done as root or superuser): 
  481.  
  482.   # /etc/init  q
  483.  
  484.  Note:  This will NOT affect terminals which are already logged in, and
  485.  therefore can be executed on a running system with active users. 
  486.  The next time the system is booted the /etc/inittab file will be
  487.  automatically referenced so the init command does not have to be reissued. 
  488.  
  489. 3    Communication Parameters
  490.  
  491.  Setting communication parameters under HP/UX should be done through PCI
  492.  software as described in the general section, above.
  493.  
  494. 2    IRIX (Silicon Graphics Iris)
  495.  
  496.  Each SGI Iris comes with at least two serial ports.  The device names for 
  497.  the first two are usually /dev/ttyd1 for port 1, and /dev/ttyd2 for port 2.
  498.  
  499.  If you are using a port other than one of these, contact your system
  500.  manager to find out the device name.
  501.  
  502.  These serial ports come with 15-pin sockets, and are compatible with PC type
  503.  15-pin to 25-pin adaptors.
  504.  
  505. 3    Disabling Logins
  506.  
  507.  Disabling logins on the Iris is done by setting the serial port to `off' 
  508.  through the System management utility under 4Dwm.  To do this you will 
  509.  have to be the superuser or log in as root.   Turning the serial port 
  510.  `off' does not mean it cannot be used, it merely prevents the Iris from 
  511.  configuring it for a special purpose (e.g., modem or terminal).
  512.  
  513.  - Note: one option for this port that will be offered is `tablet'.  DO NOT
  514.    select this option.
  515.  
  516. 3    Communication Parameters
  517.  
  518.  Setting communication parameters under IRIX should be done through PCI
  519.  software as described in the general section, above.
  520.  
  521.  - Note: SGI Iris systems are VERY sensitive to the number of stop-bits set.
  522.    Most systems tend to ignore the number of stop-bits, but the Iris
  523.    requires that these EXACTLY match what the tablet is set for.
  524.  
  525. 2    PC Systems (Windows 3.1, NT and OS/2)
  526.  
  527.  Most PC systems have one or two serial ports.  Typically, the device names
  528.  are COM1 and COM2.
  529.  
  530.  For Windows 3.1 systems only, the PACE programs GCIM and VECDIG 
  531.  require the PCI provided driver called CDDRVR (Coordinate Digitizer Driver)
  532.  to be installed.   However, the GCPWorks program does NOT require CDDRVR.
  533.  CDDRVR does NOT have to be installed for Windows NT or OS/2 systems.
  534.  
  535. 3    MODE Command
  536.  
  537.  For Windows 3.1 systems, the first command you must issue to enable tablet
  538.  communication is the MODE command.  This ensures that the serial (COM) port
  539.  to which the tablet is connected runs at the proper baud and is configured
  540.  properly for your type of digitizing table.  The format of this line depends
  541.  on the digitizing tablet being used.  This command should probably be added to
  542.  your AUTOEXEC.BAT file.
  543.  
  544. 3    CDDRVR Driver
  545.  
  546.  If you are using the GCIM or VECDIG programs on Windows 3.1 systems, you must
  547.  also install the CDDRVR digitizing table driver.  The format of the CDDRVR
  548.  command varies for each type of digitizing table.  You do NOT have to install
  549.  CDDRVR is you are using GCPWorks instead of GCIM or VECDIG.
  550.  
  551. 3    Summasketch
  552.  
  553.  The MODE and CDDRVR commands for a Summagraphics Summasketch tablet 
  554.  connected to COM2: are as follows:
  555.  
  556.   MODE COM2:9600,O,8,1
  557.   C:\PCI\DRI\CDDRVR.EXE /P/2
  558.  
  559.  Please note that unlike other systems, Windows 3.1 expects the Summasketch
  560.  to be transmitting in Packed Binary format for the GCIM and VECDIG programs,
  561.  not ASCII format.  Note:  GCPWorks uses ASCII format on all systems.
  562.  
  563. 3    Gentian/Altek
  564.  
  565.  For a Gentian or Altek digitizing table configured with factory default 
  566.  settings on COM2:, the following two lines properly set the Mode and 
  567.  CDDRVR commands:
  568.  
  569.   MODE COM2:9600,O,7,2
  570.   C:\PCI\DRI\CDDRVR.EXE /G/2
  571.  
  572.  For Gentian or Altek digitizing tables configured to be compatible with
  573.  Autocad, use the following two lines:
  574.  
  575.   MODE COM2:9600,N,8,1
  576.   C:\PCI\DRI\CDDRVR.EXE /G/2
  577.  
  578. 3    CalComp 9500
  579.  
  580.  For a CalComp 9500 digitizing table on COM1:, use the following two lines:
  581.  
  582.   MODE COM1:9600,O,7,1
  583.   C:\PCI\DRI\CDDRVR.EXE /E/1
  584.  
  585. 2    AIX (IBM RISC System/6000)
  586.  
  587.  IBM RISC System/6000 workstations usually come with two serial ports, 
  588.  (typically the device names are /dev/tty0 and /dev/tty1).
  589.  
  590.  All configuration of the serial ports is done using the `smit' system
  591.  management utility.  This includes disabling logins and setting all the
  592.  communications parameters for the port.
  593.  
  594.  If smit is not used to configure baud rate, parity, ... then it is
  595.  possible to do this directly with PCI software; however, this is not 
  596.  the recommended method, and some settings will have to be done using
  597.  smit regardless. 
  598.  
  599. 3    Using Smit
  600.  
  601.  Configuring the serial port is done using the system management utility
  602.  smit when logged in as root or as superuser.  Serial ports are considered 
  603.  to be `devices' of type `tty'.
  604.  
  605.  When changing the characteristics of the tty device, Logins should
  606.  be set to `disabled'.  The BAUD rate, PARITY, BITS per character 
  607.  (data bits) and number of STOPBITS should be changed to match the 
  608.  hardware configuration of the tablet.  Changes to other settings
  609.  may be required.
  610.  
  611.  One additional setting that is required is that the `STTY attributes
  612.  for RUNTIME' must have `clocal' added to the list.
  613.  
  614.  It is recommended that interaction between the tablet and IBM RISC System
  615.  6000 be tested to ensure proper data transmission before PCI software is 
  616.  run.  Often this is possible by using the AIX (UNIX) cat command:
  617.  
  618.   % cat /dev/tty?       (where ? is the serial port number 0 or 1)
  619.  
  620.  When buttons are pressed on the digitizer cursor (puck) characters
  621.  should appear on the terminal window.  If this happens, communication
  622.  has been established (though it still may not be proper). 
  623.  Use <Ctrl>-C to abort the the cat command.
  624.  
  625.  The PACE program TBTEST may also be of use.  This is run from EASI after
  626.  some level of communication has been established.
  627.  
  628. 2    SCO ODT (IBM PC)
  629.  
  630.  Most PC systems running SCO ODT have one or two serial ports, 
  631.  (typically the device names are /dev/tty0 and /dev/tty1).
  632.  
  633. 3    Disabling Logins
  634.  
  635.  To ensure that a login process (getty) is not running against the port for
  636.  the digitizing table, search the file /etc/ttys for the line beginning
  637.  with the terminal device name.   The first four entries on this
  638.  line should be as follows:
  639.  
  640.   ttyn    none       unknown   off
  641.  
  642.  where ttyn is the port to which the table is connected.  Edit the file, if
  643.  necessary, so that the port is defined as above. Next, you must force the
  644.  initialization process to close and to open the terminals according to the
  645.  contents of the /etc/ttys file, by entering the following command: 
  646.  
  647.   # kill  -HUP  1
  648.  
  649.  Note:  This will NOT affect terminals which are already logged in, and
  650.  therefore can be executed on a running system with active users. 
  651.  The next time the system is booted the /etc/ttys file will be
  652.  automatically referenced so the kill command does not have to be reissued. 
  653.  
  654. 3    Communication Parameters
  655.  
  656.  Setting communication parameters under ODT should be done through PCI
  657.  software as described in the general section, above.
  658.  
  659. 2    SunOS (Sun Sparcstation)
  660.  
  661.  Sun workstations usually come with at least two serial ports, (typically 
  662.  the device names are /dev/ttya and /dev/ttyb).  
  663.  
  664. 3    Disabling Logins
  665.  
  666.  To ensure that a login process (getty) is not running against the port for
  667.  the digitizing table, search the file /etc/ttytab for the line beginning
  668.  with the terminal device name.   This line should be entered in the file 
  669.  as follows: 
  670.  
  671.   ttynn    none       unknown   off
  672.  
  673.  where ttynn is the port to which the table is connected. Edit the file, if
  674.  necessary, so that the port is defined as above. Next, you must force the
  675.  initialization process to close and to open the terminals according to the
  676.  contents of the /etc/ttytab file, by entering the following command: 
  677.  
  678.   # kill -HUP 1
  679.  
  680.  Note:  This will NOT affect terminals which are already logged in, and
  681.  therefore can be executed on a running system with active users. 
  682.  
  683.  The next time the system is booted the /etc/ttytab file will be
  684.  automatically referenced so the kill command does not have to be 
  685.  reissued. 
  686.  
  687. 3    Communication Parameters
  688.  
  689.  Setting communication parameters under SunOS 4.1.X should be done through 
  690.  PCI software as described in the general section, above.
  691.  
  692. 2    Solaris (Sun Sparcstation)
  693.  
  694.  Sun workstations usually come with at least two serial ports, (typically 
  695.  the device names are /dev/ttya and /dev/ttyb).  
  696.  
  697. 3    Disabling Logins
  698.  
  699.  To ensure that a login process (ttymon) is not running against the port for
  700.  the digitizing table, search the file /etc/inittab for the line containing
  701.  the terminal device name and ttymon.  Edit the file and comment out
  702.  this line by putting a `#' at the beginning of it.
  703.  
  704.  Next, you must force the initialization process to close and to open the 
  705.  terminals according to the contents of the /etc/inittab file, by entering 
  706.  the command:
  707.  
  708.   # init  q
  709.  
  710.  Note:  This will NOT affect terminals which are already logged in, and
  711.  therefore can be executed on a running system with active users.
  712.  The next time the system is booted the /etc/inittab file will be
  713.  automatically referenced so the init command does not have to be 
  714.  reissued.
  715.  
  716. 3    Communication Parameters
  717.  
  718.  Setting communication parameters under Solaris 2.2 should be done through 
  719.  PCI software as described in the general section, above.
  720.  
  721. 2    Ultrix (Digital DECstation)
  722.  
  723.  DECstation workstations usually come with two serial ports, (typically the
  724.  device names are /dev/tty00 and /dev/tty01). 
  725.  
  726. 3    Disabling Logins
  727.  
  728.  To ensure that a login process (getty) is not running against the port for
  729.  the digitizing table, search the file /etc/ttys for the line beginning
  730.  with the terminal device name.   The first four entries on this
  731.  line should be as follows:
  732.  
  733.   ttynn    none       unknown   off
  734.  
  735.  where ttynn is the port to which the table is connected. Edit the file, if
  736.  necessary, so that the port is defined as above. Next, you must force the
  737.  initialization process to close and to open the terminals according to the
  738.  contents of the /etc/ttys file, by entering the following command: 
  739.  
  740.   # kill  -HUP  1
  741.  
  742.  Note:  This will NOT affect terminals which are already logged in, and
  743.  therefore can be executed on a running system with active users. 
  744.  The next time the system is booted the /etc/ttys file will be
  745.  automatically referenced so the kill command does not have to be 
  746.  reissued. 
  747.  
  748. 3    Communication Parameters
  749.  
  750.  Setting communication parameters under Ultrix should be done through PCI
  751.  software as described in the general section, above.
  752.  
  753. 2    VMS (Digital VAX)
  754.  
  755.  Digital VAX/VMS systems usually come with at least two serial ports, 
  756.  (typically, under VMS, the device names are TTA0:, TTA1:, etc.).
  757.  
  758.  Unlike on most systems, PCI's software does not change terminal port
  759.  settings under VMS.  To do so, the "SET TERMINAL" command is used.
  760.  This allows setting of both the communications parameters, and disabling
  761.  logins on the port.
  762.  
  763.  Additionally, the protection code on the port must be set to allow general
  764.  users permission to access the port directly.  This is done using the
  765.  "SET PROTECTION" command.
  766.  
  767. 3    Port Settings
  768.  
  769.  The SHOW TERMINAL command can be used to check the current characteristics 
  770.  of the device associated with the port.  The SET TERMINAL command can be
  771.  used to change these characteristics to match them up with those of the 
  772.  tablet.  The following list shows some of the more important characteristics 
  773.  and the usual settings.
  774.  
  775.     $ SET TERMINAL characteristic term:
  776.  
  777.     where `characteristic' is one of the following:
  778.  
  779.     Echoing:  Usually the host VAX echos any data       /NOECHO
  780.     transmitted  to  it  back   along  the  line.
  781.     Echoing must be disabled for tablets.
  782.  
  783.     Baud rates:  The  baud  rate  (usually  9600)       /SPEED=9600
  784.     on  the line and for the tablet should match.
  785.  
  786.     Parity:  Tablets transmit  with even, odd,  or      /PARITY=EVEN
  787.     no parity.  Most lines under VMS are set            /PARITY=ODD
  788.     to no parity initially.                             /NOPARITY
  789.  
  790.     Eight bits:  Each character of data is sent as      /NOEIGHT
  791.     either 7 bits or 8 bits.                            /EIGHT
  792.  
  793.     Type_ahead:  It is best to allow buffering of       /TYPE
  794.     coordinates in the typeahead buffer.  
  795.  
  796.     Broadcasting:  It is best to  prevent  broad-       /NOBROADCAST
  797.     casting  of messages  to the  tablet  in case
  798.     they are interpreted as commands.
  799.  
  800.     Permanent:  This must be used to ensure  that       /PERMANENT
  801.     changes  are  permanent.   This  may  require
  802.     system manager privileges.
  803.  
  804.  Other settings should be left at the default values.
  805.  
  806.  The SET TERMINAL command is normally inserted into the system startup 
  807.  command file, which is executed when the VAX system is rebooted.
  808.  (The system startup command file is called: SYS$MANAGER:SYSTARTUP_V5.COM
  809.  
  810. 3    Port Protection
  811.  
  812.  Setting the protection on the port is done by the following command:
  813.  
  814.   $ SET PROTECTION=(S:RWLP,O:RWLP,G:RWLP,W:RWLP)/DEVICE term:
  815.  
  816.  As with the SET TERMINAL command, this too can be inserted into the
  817.  system startup command file (SYS$MANAGER:SYSTARTUP_V5.COM).
  818.  
  819. 3    Example
  820.  
  821.  The following shows an example output of the SHOW TERMINAL command for 
  822.  a port configured for a Summagraphics Summasketch tablet:
  823.  
  824.   Terminal TTA1:, device type unknown, is online, record-oriented device, 
  825.      carriage control.
  826.  
  827.      Error count                    0    Operations completed           28711
  828.      Owner process                 ""    Owner UIC                      [PCI]
  829.      Owner process ID        00000000    Dev Prot S:RWLP,O:RWLP,G:RWLP,W:RWLP
  830.      Reference count                0    Default buffer size              255
  831.  
  832.   Terminal: _TTA1:      Device_Type: Unknown       Owner: No Owner
  833.     Input:   9600     LFfill:  0     Width: 255     Parity: Odd
  834.     Output:  9600     CRfill:  0     Page:   66     Terminate on parity errors
  835.   Terminal Characteristics:
  836.     Passall           No Echo            Type_ahead        No Escape
  837.     No Hostsync       No TTsync          Lowercase         Tab
  838.     No Wrap           Hardcopy           No Remote         Eightbit
  839.     No Broadcast      No Readsync        No Form           Fulldup
  840.     No Modem          No Local_echo      No Autobaud       No Hangup
  841.     No Brdcstmbx      No DMA             No Altypeahd      Set_speed
  842.     No Line Editing   Insert editing     No Fallback       No Dialup
  843.     No Secure server  No Disconnect      No Pasthru        No Syspassword
  844.     No SIXEL Graphics No Soft Characters No Printer Port   Application keypad
  845.     No ANSI_CRT       No Regis           No Block_mode     No Advanced_video
  846.     No Edit_mode      No DEC_CRT         No DEC_CRT2       No DEC_CRT3
  847.     No DEC_CRT4
  848.  
  849. 3    MODE Command
  850.  
  851.  The first command you must issue to enable tablet communication, is
  852.  the MODE command.  This ensures that the serial (COM) port to which 
  853.  the tablet is connected runs at the proper baud and is configured properly 
  854.  for your type of digitizing table.  The format of this line depends on the
  855.  digitizing tablet being used.  This command should probably be added to
  856.  your AUTOEXEC.BAT file.
  857.  
  858. 3    CDDRVR Driver
  859.  
  860.  In addition to issuing the proper Mode command, you must also install the 
  861.  CDDRVR digitizing table driver.  As with the Mode command, the format of 
  862.  the CDDRVR command varies for each type of digitizing table.
  863.  
  864.  
  865. 3    Summasketch
  866.  
  867.  The MODE and CDDRVR commands for a Summagraphics Summasketch tablet 
  868.  connected to COM2: are as follows:
  869.  
  870.   MODE COM2:9600,O,8,1
  871.   C:\PCI\DRI\CDDRVR.EXE /P/2
  872.  
  873.  Please note that unlike other systems, the PC expects the Summasketch
  874.  to be transmitting in `Packed Binary' format, NOT `ASCII' format.
  875.  
  876. 3    Gentian/Altek
  877.  
  878.  For a Gentian or Altek digitizing table configured with factory default 
  879.  settings on COM2:, the following two lines properly set the Mode and 
  880.  CDDRVR commands:
  881.  
  882.   MODE COM2:9600,O,7,2
  883.   C:\PCI\DRI\CDDRVR.EXE /G/2
  884.  
  885.  For Gentian or Altek digitizing tables configured to be compatible with
  886.  Autocad, use the following two lines:
  887.  
  888.   MODE COM2:9600,N,8,1
  889.   C:\PCI\DRI\CDDRVR.EXE /G/2
  890.  
  891. 3    CalComp 9500
  892.  
  893.  For a CalComp 9500 digitizing table on COM1:, use the following two lines:
  894.  
  895.   MODE COM1:9600,O,7,1
  896.   C:\PCI\DRI\CDDRVR.EXE /E/1
  897.  
  898. 1    Trouble Shooting
  899.  
  900.  The following are the most common problems encountered when using digitizing
  901.  tablets.  Please note that some of these may be operating system specific
  902.  and therefore may not be relevant to you.
  903.  
  904. 2    Port incorrect
  905.  
  906.  It is possible that the tablet is connected to the incorrect port.  For 
  907.  example, the user may think that the port (device) name is /dev/tty00 but 
  908.  in fact the physical connections have been made to port /dev/tty01. 
  909.  
  910. 2    Communications incorrect
  911.  
  912.  Double check the settings on the tablet and the line to ensure that the
  913.  communications settings for the tablet and in the TB0# parameter in the
  914.  parameter file match.  Please refer to the section on Communication
  915.  Parameters and the section for your specific tablet, for more information. 
  916.  
  917. 2    Cabling incorrect
  918.  
  919.  One of the most common problems, especially on initial configuration, is
  920.  incorrect cabling.  Refer to the installation manual supplied by the
  921.  manufacturer of the tablet and double check all connections.  A common 
  922.  error that occurs is in the connection of the tablet to the serial line.  
  923.  Often it is necessary to use a connector that flips pins 2 and 3 (receive 
  924.  and send), called a "null modem". 
  925.  
  926. 2    Tablet hung
  927.  
  928.  Occasionally tablets will "hang", that is, refuse to communicate.  Often 
  929.  this can be cleared up by powering off the tablet, waiting a few seconds 
  930.  then powering it back on. 
  931.  
  932.  For Summasketch tablets this is a common occurrence.  In this case, since 
  933.  the older Summasketchs have no on/off switch, the power pack must be 
  934.  physically unplugged and then plugged back in again after waiting 5 or so 
  935.  seconds. 
  936.  
  937. 2    Invalid serial port
  938.  
  939.  Some computer systems have serial ports dedicated to special purposes.  For
  940.  example, the Digital AXP systems dedicate the first serial port as a
  941.  console port, which then cannot be used by application software.  Please 
  942.  check the system specific section for information on any such port
  943.  limitations.
  944.